home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Performance Co-Pilot 1.3
/
SGI Performance Co-Pilot 1.3.iso
/
dist
/
pcp.idb
/
usr
/
share
/
catman
/
u_man
/
cat1
/
pmdacisco.z
/
pmdacisco
Wrap
Text File
|
1997-04-03
|
11KB
|
199 lines
PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111)))) PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111))))
NNNNAAAAMMMMEEEE
ppppmmmmddddaaaacccciiiissssccccoooo, ppppaaaarrrrsssseeee, pppprrrroooobbbbeeee - Cisco router performance metrics domain agent
(PMDA)
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////ppppmmmmddddaaaacccciiiissssccccoooo [----dddd _d_o_m_a_i_n] [----hhhh _h_e_l_p_f_i_l_e] [----iiii _p_o_r_t] [----llll
_l_o_g_f_i_l_e] [----PPPP _p_a_s_s_w_o_r_d] [----pppp] [----rrrr _r_e_f_e_s_h] [----uuuu _s_o_c_k_e_t] _h_o_s_t:_i_n_t_e_r_f_a_c_e-_s_p_e_c
[...]
////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////ppppaaaarrrrsssseeee [options] _h_o_s_t:_i_n_t_e_r_f_a_c_e-_s_p_e_c [...]
////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////pppprrrroooobbbbeeee [----PPPP _p_a_s_s_w_o_r_d] _h_o_s_t
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ppppmmmmddddaaaacccciiiissssccccoooo is a Performance Metrics Domain Agent (PMDA) which extracts
performance metrics from one or more Cisco routers.
A brief description of the ppppmmmmddddaaaacccciiiissssccccoooo command line options follows:
----dddd It is absolutely crucial that the performance metrics _d_o_m_a_i_n number
specified here is unique and consistent. That is, _d_o_m_a_i_n should be
different for every PMDA on the one host, and the same _d_o_m_a_i_n number
should be used for the same PMDA on all hosts.
----hhhh The help text describing the available performance metrics is
obtained from files with the basename _h_e_l_p_f_i_l_e rather than the
default of /_v_a_r/_p_c_p/_p_m_d_a_s/_c_i_s_c_o/_h_e_l_p.
----iiii Communicate with ppppmmmmccccdddd(1) via the given Internet _p_o_r_t.
----llll By default a log file named _c_i_s_c_o._l_o_g is written in the directory
where ppppmmmmddddaaaacccciiiissssccccoooo is started, i.e. since ppppmmmmccccdddd(1) makes /_v_a_r/_a_d_m/_p_c_p_l_o_g
(or $$$$PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR if set in the environment) its current directory,
the default logfile for ppppmmmmddddaaaacccciiiissssccccoooo is ${_P_C_P__L_O_G_D_I_R-
/_v_a_r/_a_d_m/_p_c_p_l_o_g}/_c_i_s_c_o._l_o_g. If the log file cannot be created or is
not writable, output is written to the standard error instead. The
----llll option specifies an alternative name for the log file.
----PPPP By default, it is assumed there are no user-level passwords required
to access the Cisco's telnet port. If user-level passwords have
been enabled on the Ciscos, then those passwords must be specified
to ppppmmmmddddaaaacccciiiissssccccoooo. If specified with the ----PPPP option, _p_a_s_s_w_o_r_d will be
used as the default user-level password for all Ciscos. See also
the INTERFACE IDENTIFICATION section below.
----pppp Communicate with ppppmmmmccccdddd(1) via a pipe.
----rrrr ppppmmmmddddaaaacccciiiissssccccoooo will refresh the current values for all performance
metrics by contacting each Cisco router once every _r_e_f_r_e_s_h seconds.
The default _r_e_f_r_e_s_h is 120 seconds.
----uuuu Communicate with ppppmmmmccccdddd(1) via the given Unix domain _s_o_c_k_e_t.
PPPPaaaaggggeeee 1111
PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111)))) PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111))))
IIIINNNNTTTTEEEERRRRFFFFAAAACCCCEEEE IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
As each Cisco router can support multiple network interfaces and/or
multiple communications protocols, it is necessary to tell ppppmmmmddddaaaacccciiiissssccccoooo
which interfaces are to be monitored.
The _h_o_s_t:_i_n_t_e_r_f_a_c_e-_s_p_e_c arguments on the command line define a particular
interface on a particular Cisco router. _h_o_s_t should be a hostname or a
``dot-notation'' IP address that identifies the telenet port of a
particular Cisco router. There are several components of the _i_n_t_e_r_f_a_c_e-
_s_p_e_c as follows.
protocol
One of the letters aaaa, EEEE, eeee, ffff, hhhh or ssss respectively for ATM,
FastEthernet, Ethernet, FDDI, HSSI or serial.
interface
Depending on the model of the Cisco, this will either be an integer
or a pair of integers separated by a slash (``/'').
To discover the valid interfaces on a particular Cisco, connect to the
telnet port (using tttteeeellllnnnneeeetttt(1)) and enter the command "show int" and look
for the interface identifiers following the keywords ``Ethernet'',
``Fddi'' or ``Serial''.
Alternatively run the pppprrrroooobbbbeeee command.
password
If there is a user-level password, and it is different to the
default (see ----PPPP above), it may be optionally specified here by
appending a question mark (``?'') and the password to the end of
_i_n_t_e_r_f_a_c_e-_s_p_e_c.
The following are examples of valid _i_n_t_e_r_f_a_c_e-_s_p_e_c arguments.
my-router:e1/2
123.456.789.0:s0
wancisco:f2/3?trust_me
cisco34.foo.bar.com:e2?way2cool
HHHHEEEELLLLPPPPEEEERRRR UUUUTTTTIIIILLLLIIIITTTTIIIIEEEESSSS
The pppprrrroooobbbbeeee command may be used to discover the names of all interfaces for
a particular Cisco router identifiled by _h_o_s_t. The ----PPPP argument is the
same as for ppppmmmmddddaaaacccciiiissssccccoooo.
The ppppaaaarrrrsssseeee command takes exactly the same arguments as ppppmmmmddddaaaacccciiiissssccccoooo, but
executes outside the control of any ppppmmmmccccdddd(1) and so may be used to
diagnose problems with handling a particular Cisco router and/or one of
its interfaces. Additional diagnositc verbosity may be produced using
the ----DDDD 11114444333333336666 command line option. Diagnostics are generated on standard
error as each sample is fetched and parsed.
PPPPaaaaggggeeee 2222
PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111)))) PPPPMMMMDDDDAAAACCCCIIIISSSSCCCCOOOO((((1111))))
IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
If you want access to the names, help text and values for the Cisco
performance metrics, do the following as root:
# cd /usr/pcp/pmdas/cisco
# ./Install
If you want to undo the installation, do the following as root:
# cd /usr/pcp/pmdas/cisco
# ./Remove
Both the Install and Remove scripts take an optional -_N argument to
specify that just the performance metrics name space for the Cisco
metrics is to be installed or removed. This is useful when you wish to
access Cisco metrics on other machines, but do not wish to have the
ppppmmmmddddaaaacccciiiissssccccoooo PMDA collecting metrics on the local machine.
ppppmmmmddddaaaacccciiiissssccccoooo is launched by ppppmmmmccccdddd(1) and should never be executed directly.
The Install and Remove scripts notify ppppmmmmccccdddd(1) when the agent is installed
or removed.
FFFFIIIILLLLEEEESSSS
////eeeettttcccc////ppppmmmmccccdddd....ccccoooonnnnffff
command line options used to launch ppppmmmmddddaaaacccciiiissssccccoooo
////vvvvaaaarrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////hhhheeeellllpppp
default help text file for the Cisco metrics
////uuuussssrrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////IIIInnnnssssttttaaaallllllll
installation script for the ppppmmmmddddaaaacccciiiissssccccoooo agent
////uuuussssrrrr////ppppccccpppp////ppppmmmmddddaaaassss////cccciiiissssccccoooo////RRRReeeemmmmoooovvvveeee
undo installation script for the ppppmmmmddddaaaacccciiiissssccccoooo agent
$$$${{{{PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR----////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg}}}}////cccciiiissssccccoooo....lllloooogggg
default log file for error messages and other information from
ppppmmmmddddaaaacccciiiissssccccoooo
SSSSEEEEEEEE AAAALLLLSSSSOOOO
ppppmmmmccccdddd(1)
PPPPaaaaggggeeee 3333